في هذه المقالة قمت بذكر بعض التلميحات لكتابة تعليمات برمجية نظيفة 
بحيث تسهل على كل مبرمج يتبعها بالرجوع إلى برامجه وفهم تعليماته البرمجية 


الدوال: 


1 -أسماء الدوال يجب أن تتكون من فعل واسم يصفان هدف هذه الدالة» ويجب كتابة الحرف الأول من كل كلمة 
بحرd‏ بير Print () ùn Jı Printstudentlist () :لlin .Capital [etter‏ 
2 -الدالة يجب أن يكون لها هدف وحيد مغلا حساب معدلات الطلاب وطباعة أسماء الطلاب والحصول على 

الإدخالات بدالة واحدة أم ثلاث دوال منفصلة. 

3 -الدوال التي تعيد قيمة يجب أن تعيد تلك القيمة من خلال عبارة ۲۴٤01۲١‏ وليس من خلال قائمة المعاملات 
parame te15)‏ الممررة. 

4 -الدالة التي لا يمكن أن تتسع في صفحة مطبوعة واحدة على الأرجح أنها معقدة وطويلة ويجب أن يتم تقسيمها 
إلى أقسام أصغر. 

5 - كل دالة يجب أن تحوي قسم في رأسها يحوي شرح عن عملها و عن المتغيرات التي يجب تمريرها و كل القيم 
المحتمل إعادتهاء وبذلك فإن أي شخص يقرأ تلك الدالة ليس مضطراً إلى قراءة الدالة بالكامل وتتبع تنفيذها ليفهم 
عملهاء مثال: 

هذه الدالة تأخذ 3 معاملات للدخل: مصفوفة تحوي الأرقام التسلسلية للطلاب */ 
ومصفوفة تحوي علامات الطلاب والمعامل الثالث هو الرقم المراد البحث عنه * 
وبعدها تقوم بالبحث في المصفوفة الأولى حسب الرقم المدخل وإذا لم يتم إيجاد * 


أي نتيجة ستعيلر الدالة القيمة /-1 وإلا فإنها ستعيد علامة الطالب/الموجود * 
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التعليمات البرمجية: 


1 -استخدم مقداراً كافياً من المسافات البيضاء (طاة1 ,#عهم؟ ,۴٤١1ع‏ لجعل التعليمات البرمجية واضحة. 
2 -ضع التعليمات التي تنتهي بفاصلة منقوطة و أقواس 3 بأسطر منفصلة رباستنناء الحلقات التكرارية)» مثال: 


For—(4-=-0771 < 5741+ for (i=0;i<5;1++) 
{ بينما الأفضل‎ { cout<<i*j; j=j-3; } 
cout << i * j; 
3= از‎ - 37 
} 
فحص الأخطاء:‎ 


1 -أعط المستخدم معلومات مفيدة في حال حصل خطاً معين بالبرنامج» ولا تقم يإاخافته بوضع عبارات مفاجئة 
ومربكة مثل: "قيمة غير صحيحة" بينما يفضل: "الرجاء إدخال أرقام بين 1 و 10". 

2 -تأكد من أن البرنامج خالي من الأخطاء الداخلية الممكنة مثل القسمة على الرقم 0 » نسخ النصوص أو تقسيم 
الأحرف في النصوص التي تحوي القيمة N01‏ » الإشارة إلى عناصر خارج حدود المصفوفة ...الخ. 

3 -حصن برنامجك من الاستخدام السيئ» وذلك بجعله آلياً قدر الإمكان» وكل الإدخالات التي تصل من مصادر 
خارجية يجب أن يتم فحصها والتأكد من صلاحيتهاء مثال التأكد من أن الرقم المدخل بين قيمتين محددتين» أو أن 
الملف المدخل موجود قبل البدء بقراءته. 


المتحولات / الثوابت: 
1 -اختر أسماء المتحولات والثوابت بحذر» مغال: 
c=a - b; ja Î score = total points = points_missed;‏ 
2 -عرف كل المتغيرات والثوابت في قمة الدالة. 
3 -المتغيرات بشكل عام لا يجب أن يتم شحنها بقيم يتم حسابها بنفس السطر الذي عرفت فيه» وبالرغم من ذلك 
فإن شحنها بقيم ثابتة مقبول» مغال: inte = sqrt(b)y —jùa Is int-e-=-07‏ 
4 -ضع تعليقاً لكل متغير قمت بتعريفه لوصف عمله. 
5 -بشكل عام» يجب أن تكون أسماء كل الثوابت بأحرف كبيرة وأسماء المتغيرات بأحرف صغيرةء مغال: 


const int NAME _ LEN =4; sg int num_of students = 20; // or numOfStudents 


6 - استخدم الثوابت لكل الأرقام السحرية مثل قيمة ۲1 () أو من أجل كل قيمة يمكن أن يتم استخدامها أكثر من مرة. 


التوثيق: 


1 -اكتب تعليقات تصف لماذا تمت العملية أكثر من كيف تمت» مغال: 
تقسيم مجموع العلامات على عدد الطلاب // 
بيغا الاأفضل: 
حساب قيمة متوسط علامات الطلاب // 
2 -دائما ضع اسمك» التاريخ» ووصف البرنامج في أعلى المستند البرمجي (البرنامج). 
3 -اجعل تعليقاتك تقول شيئاً عن العمليات البرمجية حيث أنها لا تستطيع أن تشرح نفسهاء مغال: 


level++; // Add 1 to level 
بينما الأفضل:‎ 


level++; // Advance to next level before processing remaining lives 
-نموذجياًء التعليق يشرح مجموعة منطقية من الأسطر البرمجية أفضل من التعليق الذي يشرح سطر واحد.‎ 
-تجنب كل أو معظم الاختصارات عند كتابة التعليقات حتى تكون واضحة ومفهومة.‎ 
-قم بفصل التعليمات البرمجية عن التعليقات بشكل واضح.‎ 
-استخدم نمط تعلیقات بحیث لا يكون ممل بشكل مفرط أو مضيع للوقت.‎ 
مهد للبرنامج بتعليقات قبل البدء بكتابته أفضل من أن تقوم بكل عمليات التوثيق في النهايةء وبالتالي ستحمي‎ - 
وقتك من وجوب إيجاد الأماكن الدقيقة أو نسيان بعض التفاصيل» أو الافتراضات. ودقة التصميم.‎ 


طب ا1ن 3 بلا 00 


النهاية 
أتمنى أن تكون المقالة مفيدة ونالت استحسانكم 


Fuad Prînee :بتكلı‎ 
Fuad-prince@hotmail.eom 
www.SvSonline.org 


www.AhlamSoft.wordpress.com 


